.. _ecmSxCfg_AutoTorq_SetValue: ecmSxCfg_AutoTorq_SetValue ========================== -------------------------- SYNOPSIS -------- .. code-block:: none t_success ecmSxCfg_AutoTorq_SetValue( t_i32 NetID, t_i32 Axis, t_i32 OutTorqVal, t_i32 *ErrCode, ) DESCRIPTION ----------- - 이 함수는 자동토크출력 기능에서의 토크 값 설정 모드(Torque Value Mode)가 ‘Single-Value Mode’로 설정된 경우에만 사용하는 함수로서, 토크 모드로 전환되었을 때 출력되어야 하는 토크 값을 정의하는 함수입니다. PARAMETER --------- - NetID : Network 번호 - Axis : 대상 축 번호. - OutTorqVal : 출력 토크값을 설정한다. 토크값은 0.1% 단위의 값으로 설정한다. 다시 말해서 이 값을 1로 하면 정격토크의0.1%의 토크를 의미하며, 10은 정격토크의1%의 토크를 의미합니다. - ErrCode : 이 매개 변수를 통하여 현재의 에러 코드를 반환합니다. 단, 이 매개 변수에 NULL을 전달하면 에러 코드를 반환하지 않습니다. RETURN VALUE ------------ - 이 리턴값은 불 형(Boolean Type) 을 가지고 있습니다. +-------+--------------------------------------+ | Value | Meaning | +=======+======================================+ | 0 | 함수 수행에 실패하였음을 의미합니다. | +-------+--------------------------------------+ | 1 | 함수 수행에 성공하였음을 의미합니다. | +-------+--------------------------------------+ EXAMPLE ------- .. code-block:: cpp :linenos: // Single-Value 모드로 설정하여 자동토크출력기능을 사용하는 예 제입니다. #include "ComiEcatSdk_Api.h" #define AXIS 0 #define TORQ_VAL 50 // 출력 토크값. 값의 단위는 0.1%이다. 따라서 50은 5%를 의미한다 t_32 Error_Num = 0;//함수 별 에러 코드 저장 변수 /*************************************************************** * OnProgramInitial : 이 함수는 가상의 함수로서 프로그램 초기화 루틴이 * 적용되는 부분을 의미합니다. //5~9장 사이 내용 참고 ***************************************************************/ void OnProgramInitial() { TEcDevInfo Device_Info; //디바이스 정보 저장 할 구조체 t_i32 Device_Num = 0; t_success nIsLoaded = ecDll_Load (); if(!ecGn_LoadDevices(&Error_Num)){ //장치 로드 //로드 실패시 예외 처리 } if(!ecGn_GetDevInfo(Device_Num,&Device_Info, &Error_Num)){ //디바이스 정보 로드 실패 시 예외 처리 } //ALState OP모드로 전환 ecNet_SetAlState(Device_Info.NetIdx, ecAL_STATE_OP, &Error_Num); ecmSxCtl_SetSvon(Device_Info.NetIdx, AXIS0, &Error_Num); } //OnProgramInitial 함수 끝 /******************************************************************** * OnSigleTorq: 이 함수는 OnSigleTorq 사용 입니다 * 많은 세팅 관련 함수가 있지만 경우에 따라 사용자가 선택해서 사용 *********************************************************************/ void OnSigleTorq () { // 1) 토크값설정모드(Torque Value Mode) 설정 if(!ecmSxCfg_AutoTorq_SetValMode (Device_Info.NetIdx , AXIS, ecmATRQ_VAL_SINGLE, 1, &nErrCode)) { //실패 시 예외처리 } // 2) 출력 토크값 설정 if(!ecmSxCfg_AutoTorq_SetValue (Device_Info.NetIdx , AXIS, TORQ_VAL, &nErrCode)) { //실패 시 예외처리 } // 3) 자동토크출력 기능 활성화 if(!ecmSxCfg_AutoTorq_SetEnable (Device_Info.NetIdx , AXIS, true, true, &nErrCode)) { //실패 시 예외처리 } // 4) PTP 이송을 수행한다. => 이 이송이 완료되면 자동으로 토크 출력됨. if(!ecmSxMot_Move (Device_Info.NetIdx , AXIS, 100000, &nErrCode)) { //실패 시 예외처리 } // 5) 자동토크출력 기능이 완료될 때까지 기다린다. // 참고로, 토크모드로 전환되면 ecmSxSt_GetMotState() 함수는 ecmMST_IN_AUTO_TORQ_MDOE(15) 값을 반환한다. if(!ecmSxSt_WaitCompt (Device_Info.NetIdx , AXIS, &nErrCode)) { //실패 시 예외 처리 } // 6) 앞서 ecmSxCfg_AutoTorq_SetValue() 함수를 실행할 때 IsOneShotEnable 매개변수의 값을 true로 하였으므로 여기에서 비활성화하지 않아도 자동으로 비활성화된다. 그렇지 않으면 여기에서 ecmSxCfg_AutoTorq_SetValue() 함수를 이용해서 비활성화할 필요 있다. // }